home *** CD-ROM | disk | FTP | other *** search
/ SunSoft Catalyst CDWARE 1996 May to August / Catalyst CDWARE 1996 May to August.iso / .products / .bin / httpd / Solaris_1 / Help / ReadMe-Reader.txt < prev   
Text File  |  1995-11-01  |  15KB  |  334 lines
  1. Adobe(TM) Acrobat(TM) Reader UNIX(R) Read Me Notes for Version 2.1
  2.  
  3.  
  4. This Read Me file contains last-minute product information for Acrobat 
  5. Reader 2.1. The "Installation and Getting Started Guide" information and the 
  6. online guide (Help-Reader.pdf) will also provide essential information to help
  7. you begin using Acrobat Reader.
  8.  
  9.  
  10. What's New in Acrobat Reader 2.1
  11. ================================
  12.  
  13. Acrobat 2.1 contains many new features and improvements over Acrobat 1.0.  All
  14. features are described in the Help-Reader.pdf document. Changes of note 
  15. include: we no longer require nor install Display PostScript (TM) or DPS-NX; 
  16. the ability to follow cross-document links, including embedded URLs; and the 
  17. ability to open secured files.
  18.  
  19. Acrobat Reader now accepts some specially enabled plug-ins, which enable users 
  20. to take advantage of new capabilities in PDF files created with Acrobat 
  21. Exchange. Two new plug-ins are Weblink and AutoClose. Weblink enables you to 
  22. follow links and bookmarks to other PDF and HTML documents on the World Wide 
  23. Web. AutoClose closes the least-recently-used document when you reach the 
  24. maximum number of open documents.
  25.  
  26. Acrobat Reader prints to PostScript printers. We do not support printing to 
  27. other printers, such as Sun's NeWSprint or PCL printers.
  28.  
  29.  
  30. Known Issues with Acrobat Reader
  31. ================================
  32.  
  33. 1. SunOS 4.1.3 or 4.1.4 users running the X11/NeWS server:
  34.  
  35.    You must install patch number T100444 (with a minor number greater than 73)
  36.    to your system before the application can be run.  This patch fixes a problem
  37.    in the X11/NeWS server that prevents all X Window System clients built with 
  38.    Motif 1.2.3 from hanging their server.
  39.  
  40.    Under certain circumstances on SunOS 4.1.3 or 4.1.4 systems running this 
  41.    patched X11/NeWS server, the session may still hang due to a different 
  42.    X11/NeWS server problem we recently discovered.  The cause of this hang is 
  43.    not yet determined.  Multiple clicks in the scroll bars to move the view 
  44.    pane seem to cause this problem.  The problem is intermittent and cannot be
  45.    reproduced with regularity.
  46.  
  47.    We are working with Sun to find the cause for this problem.  For now we 
  48.    recommend that you run the application with an X11R5 server obtained from
  49.    a third party or you may obtain the sources for the server from the X Window
  50.    Consortium, Inc., and build your own.
  51.  
  52. 2. HP-UX users:
  53.    
  54.    You might receive warning messages indicating missing fonts. There are
  55.    several messages you could receive depending on your configuration.
  56.  
  57.    - You are displaying on an X server that has no HP-ROMAN8 font defined. The 
  58.    message you receive is:
  59.    
  60.     Warning: No fonts available with charset "HP-ROMAN8", using "ISO8859-1" 
  61.     
  62.    In this situation, upper-ascii characters will display incorrectly. To fix 
  63.    this, change your language to an ISO8859 language 
  64.    (e.g., setenv LANG american.iso88591).
  65.    
  66.    - The variable fontList is specified and its encoding doesn't match the 
  67.    encoding of the application. If you specified an ISO font list, you
  68.    will receive an error that says the encoding for fontList doesn't match 
  69.    the locales encoding. You need to change your LANG variable as listed above.
  70.     
  71.    - The Helvetica used by the Motif toolkit is not available on the system in 
  72.    the hp-roman8 encoding. The message you might receive is:
  73.    
  74.    Warning: Cannot convert string
  75.    "-adobe-helvetica-bold-r-normal-*-*-120-*-*-*-*-hp-roman8" to type FontStruct
  76.    
  77.    This occurs when you are running on HP but displaying on a non-HP system. To
  78.    fix this, set an application resource for fontList to specify a font that
  79.    exists on the system.
  80.        
  81. 3. If Acrobat Reader is started from a directory that cannot be determined then
  82.    the launch will fail and Reader may become interfaceless but still run.
  83.    Please run Reader from a directory that the "pwd" command can stat.
  84.    
  85. 4. Files listed in the File menu  are "recent files" and depend upon exact path 
  86.    names. If you open a file in a session using and automounter and the 
  87.    automounter goes down, attempting to open the "recent file" will give a 
  88.    "No such file or directory" error.   
  89.     
  90. 5. Acrobat Reader does not warn the user when the preferences file cannot be
  91.    written. Please make sure the '.acrorc' file in your home directory is
  92.    writable if you wish to save preferences.
  93.     
  94. 6. When exiting Full Screen mode, bookmark and thumbnail views are not 
  95.    displayed. To display them, press the appropriate button in the Tool Bar. 
  96.     
  97. 7. Window managers other than those listed in the "Installation and Getting 
  98.    Started Guide" are not supported.
  99.    
  100. 8. Users cannot convert secure PDF documents to PostScript from the command 
  101.    line even though they are able to print the files from Acrobat Reader.
  102.  
  103. 9. We recommend you avoid giving PDF files long names (greater than 32 
  104.    characters). A Novell server displays the long file name to a Macintosh
  105.    user, but the Macintosh Operating System prevents Acrobat from opening the 
  106.    file. This is not a problem on Windows because Novell truncates the name to 
  107.    8.3 structure.
  108.    
  109. 10. All cross-document links made from Windows list the path as all uppercase
  110.    letters. Acrobat Reader may not be able to locate the file specified in 
  111.    the path if UNIX sees the path in mixed case instead of all upper- or 
  112.    lowercase. 
  113.    
  114. 11. Modal dialog boxes may appear to be "lost" behind the main document window.
  115.    When they are behind the main window, they are still active and prevent the
  116.    user from doing anything. To bring the dialog to the front, click anywhere 
  117.    in the main window. You can now dismiss the dialog and proceed.  
  118.      
  119. 12. If another window or icon obscures the document view, scrolling the window
  120.    modally using the hand tool or scrollbar thumb to scroll the view may leave
  121.    newly exposed areas that were underneath the obscuring window unupdated.
  122.    This occurs only if the window manager's auto raise feature is turned off,
  123.    the page is not in the page cache, and the user scrolls the document image
  124.    modally.  The document information may be refreshed by changing the view to
  125.    some other page then back again, causing the viewer to recieve an expose
  126.    event by obscuring it with another window, or running the "xrefresh" program.
  127.    You can also work around this problem if you enable the window manager's
  128.    auto raise feature.
  129.    
  130. Known Issues with Weblink
  131. =========================
  132.  
  133. Acrobat's Weblink plug-in supports Netscape version 1.1 or later and Mosaic
  134. version 2.5 or later. The preferences for Weblink are stored in $HOME/.weblink.
  135.  
  136. - Issues working with Netscape:
  137.  
  138. 1. When launching Netscape from Acrobat Reader, you get a locale warning 
  139.    message on your command line:
  140.  
  141.    netscape-v11N: locale: `iso_8859_1' not supported by Xlib; using `C'
  142.  
  143.    this is nothing to be alarmed about.
  144.  
  145. -Issues working with Mosaic:
  146.  
  147. 1. Whenever you pass a Universal Resource Locator (URL) to Mosaic, you get the 
  148.    following messages on your command line:
  149.  
  150.    MoCCINewConnection(); I've been called
  151.    Mosaic: got a CCI connection
  152.  
  153.    this is nothing to be alarmed about. 
  154.    
  155. 2. Due to a problem with Mosaic, its window does not pop to the front when you
  156.    click an embedded URL in a PDF file. 
  157.    
  158. 3. Mosaic has trouble following subsequent URLs whose base is the same as the 
  159.    previous URL. For example, your first embedded URL is the following:
  160.    
  161.         http://www.adobe.com/Product.html
  162.         
  163.    The next embedded URL you click on inside a PDF file is:
  164.    
  165.        http://www.adobe.com
  166.        
  167.    In this scenario, Mosaic will reload the first URL instead of the second (and
  168.    correct) URL.
  169.    
  170.    
  171. Miscellaneaous Information
  172. ==========================
  173.  
  174. 1. You may choose to print to any PostScript printer with the following command
  175.    lines:
  176.  
  177.     acroread -toPostScript -pairs myfile.pdf /tmp/$$.ps
  178.     lp -dprinter_name /tmp/$$.ps
  179.     rm -f /tmp/$$.ps
  180.     
  181.    To generate level 2 PostScript, add the -level2 argument to the command
  182.    line:
  183.    
  184.        acroread -toPostScript -level2 myfile.pdf
  185.     
  186. 2. At the command line, type 'acroread -help' or 'acroread -helpall' for more
  187.    information on command line options. Note that when using these command lines
  188.    you must supply a DISPLAY variable if one is not already defined in your
  189.    environment.
  190.    
  191. 3. Set the following Window manager resources to make Acrobat behave similar
  192.    to the Windows or Macintosh versions.
  193.   
  194.    AutoInputFocus: false     If true, the main window will lose focus when
  195.                    the status windows appear and the keyboard 
  196.                    accelerators will break.
  197.    
  198.    SetInput: select        Must click to type in the dialog box.
  199.    
  200.    AutoRaise: true        Brings the window to the front when it gets 
  201.                    the focus.
  202.    
  203.    For MWM, these additional resources should be set to maintain behavior closer
  204.    to Mac and Windows.
  205.    
  206.    autoKeyFocus: True        When the window is withdrawn, it gives focus to 
  207.                    the window that previously had focus.
  208.                    
  209.    deiconifyKeyFocus: True    Gives the window the focus when deiconified.
  210.    
  211.    startupKeyFocus: True    Gives the window the focus when it's created.
  212.    
  213.    keyboardFocusPolicy: explicit    Must click to type in the dialog box.
  214.    
  215.    focusAutoRaise: True        Bring the window to front when it gets focus.
  216.    
  217. 4. Using either BSD- or System5-style printing is controlled by resources set
  218.    in the .Xdefaults file.
  219.    
  220.    The default from Acrobat is System5-style and the associated resource values
  221.    are as follows:
  222.    
  223.        *acroread.lprCommand: /usr/bin/lp
  224.        *acroread.lprStyle: SYSV
  225.    
  226.    To set the resources for BSD-style printing, set the resources as follows:
  227.    
  228.        *acroread.lprCommand: /usr/ucb/lpr
  229.        *acroread.lprStyle: BSD
  230.  
  231. 5. The HP Motif library uses different virtual key bindings than Sun's. As a 
  232.    result, when running on a Sun and displaying on an HP, the keys for 
  233.    DeleteLine, DeleteChar, InsertLine, and InsertChar may not be properly 
  234.    defined by default. You can tell if you get warnings of the form 
  235.    'Warning: cannot convert string "<Key>DeleteChar" to type VirtualBinding'.  
  236.    One consequence of this is that the Esc key on some HP keyboards will not 
  237.    work to exit Full Screen mode.
  238.  
  239.    To fix this, load a file with the appropriate key bindings using the 
  240.    "xmbind" command.  See the man page for xmbind for where it looks for the 
  241.    file. Check the bindings using  "xprop -root | grep BIND".
  242.  
  243.    The resulting string should include hpDeleteLine, hpDeleteChar, hpInsertLine,
  244.    and hpInsertChar.
  245.    
  246. 6. Sometimes the quality of color images on 8-bit pseudocolor displays will 
  247.    suffer because Acrobat can't grab enough colors in the default color table. 
  248.    
  249.    A color cube is a "block" of colors, n by m by p, that Acrobat reserves for 
  250.    rendering colors. Acrobat looks for the nearest color it can find to the one 
  251.    it wants in this cube.  The larger the cube, the finer the color resolution.
  252.  
  253.    Color allocation is controlled by four resources:
  254.     *minColorCube -- the minimum color cube size; default 3 (which reserves 
  255.     3-cubed colors plus 3x2 grays, or 33 slots in the color table)
  256.  
  257.     *targetColorCube -- the size of color cube that Acrobat initially tries to 
  258.     allocate; default 5, yielding 5-cubed colors plus 5x2 grays for 135 color 
  259.     table slots (the largest allowed value is 6, since on an 8-bit color display
  260.     there are only 256 colors and 7-cubed is greater than 256).
  261.  
  262.     If Acrobat can't find the 135 slots that *targetColorCube calls for, it 
  263.     shrinks the color cube by 1 in each dimension successively (5x5x4, then 
  264.     5x4x4, then 4x4x4, and so on) until it comes up with a number of colors that
  265.     will fit. If it reaches the *minColorCube size and still can't fit a color 
  266.     cube in the color table, it uses the next resource:
  267.  
  268.     *noPrivateColormap: if this is True, failure to fit in the standard color 
  269.     map will cause the image to drop into GrayScale (if the visual is not 
  270.     GrayScale by default, an alert will appear).  If it is False, Acrobat will 
  271.     allocate a private color map and allocate its colors there.
  272.  
  273.     *usePrivateColormap:  if this is True, Acrobat won't even try to fit its 
  274.     colors into the default color map; it will always allocate its own.  
  275.     
  276. 7. The following are other resource settings that may be helpful. You can place
  277.    these in your .XDefaults file.
  278.    
  279.    *systemPlugInPath -- the location of plug-ins available to all users of the
  280.    installed executable; default is $ACRO_INSTALL_DIR/$ACRO_CONFIG/plug_ins.
  281.    
  282.    *userPlugInPath -- the location of the user's private plug-ins; default
  283.    $HOME/plug_ins.
  284.    
  285.    *useFrontEndProgram -- controls running a single process of Acrobat (default)
  286.    or multiple processes; default is True.
  287.    
  288.    *noteTitleFontName -- controls the default font used in the titles of Acrobat
  289.    notes; default is Helvetica.
  290.    
  291.    *noteTitleFontSize -- controls the font size used to display the titles of 
  292.    Acrobat notes; default is 12.
  293.    
  294.    *bookmarkFontName -- controls the default font used to display bookmarks;
  295.    default is Helvetica.
  296.    
  297.    *bookmarkFontSize -- controls the font size used to display bookmarks;
  298.    default is 12.
  299.    
  300.    *maxOpenDocuments -- controls the maximum number of documents open at any
  301.    given time; default is 20. Do not set this value below 2. 
  302.    
  303. 8. Everytime you print from Acrobat Reader, a dialog will appear with the job
  304.    ID. You can use the ID to kill the job, if you like. You must dismiss the 
  305.    dialog by clicking OK.
  306.    
  307. 9. On a Tektronics X-Terminal:
  308.  
  309.    If displaying a document in Full Screen mode using a black background, a 
  310.    small white line will appear along the bottom and right edges of the 
  311.    background. This is due to a problem in the olwm running locally on the 
  312.    X-Terminal and is not an Acrobat bug.
  313.    
  314. 10. Characters in PDF files that are not part of the ISO8859 encodings will not
  315.    display when the text is selected and pasted elsewhere. This is most notable
  316.    with the Registered and Trademark symbols.
  317.    
  318. Adobe, the Adobe logo, Acrobat, the Acrobat logo, and PostScript are trademarks 
  319. of Adobe Systems Incorporated or its subsidiaries and may be registered in 
  320. certain jurisdictions. HP is a registered trademark and HP-UX is a trademark of
  321. Hewlett-Packard Company. Motif is a trademark of Open Software Foundation, Inc. 
  322. Solaris is a registered trademark of Sun Microsystems, Inc., which has not 
  323. tested or approved this product. Sun and OpenWindows are trademarks of Sun 
  324. Microsystems, Inc. SPARC is a registered trademark of SPARC International, Inc. 
  325. SPARCstation is a registered trademark of SPARC International, Inc., licensed 
  326. exclusively to Sun Microsystems, Inc. and is based upon an architecture 
  327. developed by Sun Microsystems, Inc. UNIX is a registered trademark in the 
  328. United States and other countries, licensed exclusively through X/Open Company, 
  329. Ltd. X Window System is a trademark of the Massachusetts Institute of 
  330. Technology. All other products or name brands are trademarks of their 
  331. respective holders.
  332.  
  333. copyright 1983 - 1995 Adobe Systems Incorporated. All rights reserved.
  334.